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Part 2: the first steps 
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There are so many different configurations of the SC 12 that we only have 
space here to cover the basic installation and operation of the Personal 


Mini Webserver. 


During programming and remote operation of 
the Personal Mini Webserver, it is always 
helpful to have the Internet site 
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on hand (Figure 1). This contains a 
complete, up-to-date index of the 
software documentation for the SC12 





chip. For more in-depth information 
on any of the procedures described 
below, this documentation can 
always be consulted. 

Before the Personal Mini Web- 
server can be programmed for its 
final application, a few questions 
need to be answered: 
< Is the circuit completely func- 
tional? 
< How will the basic settings be 
made? 
< How will files be transferred to the 
Personal Mini Webserver? 
< How will the Personal Mini Web- 
server be provided with a network 
address? 
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Functional test 





Once assembly of the Personal Mini 
Webserver hardware has been suc- 
cessfully completed, a full functional 
test should be carried out. First con- 
nect the Personal Mini Webserver to 
a PC via connector K4 and a null 
modem cable, and start a terminal 
program. This could be HyperTermi- 
nal, provided with Windows, 
although in principle any terminal 
software will work fine, as long as 
the communications parameters are 
set as follows: 


19,200 bits/s 
8 data bits 
No parity 

1 stop bit 


Elektor Electronics 10/2001 


€ ù% 3 


Fe load 


at 


Home 


Netscape: IPC@Cchip Documentation index 
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IPC@Chip Documentation index 


BIOS: Interrupts for several PC services 


Col: Software interface to COI 
IPC@Chip startup initialization 


CUMMAND: Description of the command processor. 
CONFIG: System configuration based on CHIP.INI file. 


DOS: Interrupt Ox41 functions 


External Disk Drive B: Interface Definition 


PUSSIL: Interface to the serial ports. 


Hardware API: Including FFE and HAL 
l-C: Interface definition for the 2C Bus Interface 


Ethernet: Packet Driver Interface 

PPP Interface: How to configure the 5C 12 PPP server. 
RTOS API: Interface definition for RTOS interface. 
TCP/IP API Interface definition for the TCP/IP sockets. 


TFTP server: Short description of the SC12 TFTP server. 





Figure |. Index of all documentation of the Application Program Interfaces of the 


IPC@Chip. 


Table I. 


@CHIP-RTOS 

Copyright (c) Beck 1999 

SC12 

Serialnumber=012BE 

Bootstrap version 02.06 

Bios version V1.00 
LARGE PPP 

Build: May 4 2001 

Starting TCPIP 

Init network 

Open ethernet packet 
interface 

PPP client 

Config server 

FTP server 

Web server 

Telnet server 

Ext. disk interface. 
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No handshake 


As usual, when the IPC@CHIP is 
switched on, the LED should flash 
three times: one long flash and then 
two short. The first messages from 
the webserver should appear on the 
monitor (Table 1). 


Press the ENTER key, and in the ter- 
minal window you should see the 
familiar line: 


A:\ 


This looks just like a DOS prompt; 
and indeed it is. In fact this is a DOS 
clone called RTOS. Our readers of 
more advanced years, who grew up 
with DOS, will have no difficulty in 
getting to grips with RTOS com- 
mands such as copy, md, cd, rd, del, 


format and so on. The command help causes 
RTOS to produce a list of all the available 
commands, which are described in full, along 
with all parameters, in ‘COMMAND: Descrip- 
tion of the command processor’ at www.bcl- 


online.de/documentation/ api/command.htm. 


Simple I/O test 


Next we check that the I/O ports of the $C12 
are functioning correctly. The signals on con- 
nector K6 correspond to I/O address 0x100, 
while those on K7 correspond to address 
0x101. On both connectors, the outputs are on 
the even-numbered pins, and the inputs are 
on the odd-numbered pins. The outputs can 
readily be tested by connecting each pin in 
turn to +5 V via an LED (and 1 KQ series cur- 
rent-limiting resistor). 

In order to activate the ALE and CS signals 
of the SC12, the following two commands can 
be entered at the prompt: 


PCS 1 
ALE 1 


The outputs can now be switched on and off 
using the OB (OutByte) command. This com- 
mand requires addresses and data in hexa- 
decimal format. So, for example, in order to 
write the decimal value 170 (or AAh) to con- 
nector K6, the following command is required: 


A:\OB 100 AA 
which elicits the confirmation: 
OB address=0x0100 data=OxAA 


The IB (InByte) command behaves similarly. 
The command 


A:\IB 100 
produces the result 
IB 0x0100=0x00, 


if all inputs are low. 


Initialisation 


Signals such as ALE and PCS, which are 
required for LCDs, digital I/Os or other expan- 
sion ports, can be activated immediately on 
system start-up, either in an autoexec.bat file, 
or in the file chip.ini. 

In the first case, we simply require the two 
lines 
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Example 
CHIP.INI file 


[STDIO} 
STDIN = EXT COM 
STDOUT = EXT COM 


[IP] 

ADDRESS= 192.168.100.101 
NETMASK=255.255.255.0 
GATEWAY = 192.168.100.254 


[DEVICE] 
NAME=WEBIO 


[TELNET] 
ENABLE=0 


[UDPCFG] 
LEVEL=0x00 


[WEB] 

ENABLE=| 
MAINPAGE=MAIN.HTM 
DRIVE=0 
ROOTDIR=\WEB\ 


[FTP] 

ENABLE= | 
USERO=FTP 
PASSWORDO=FTP 


[TELNET] 
ENABLE=| 
USERO=TEL 
PASSWORDO=TEL 


Figure 2. A chip initialisation file such as this 
contains the basic settings of the Personal Mini 
Webserver. 


PCS 1 
ALE 1 


in autoexec.bat. If autoexec.bat is not 
present, for example after a BIOS update, a 
suitable file can be created using a text edi- 
tor and sent to the SC12 using the XModem 
protocol with the terminal program. 
Chip.ini can be compared with the con- 
fig.sys file in a DOS system. This text file con- 
tains all the settings which the $C12 requires 
at start-up. At system start, autoexec.bat is 


is started, even if the program has 
not exited. If this behaviour is not 
desired, the following line can be 
added to the start of the 
autoexec.bat file: 


BATCHMODE 1 


After this command all programs are 
executed sequentially. Conversely, 
the command 


BATCHMODE 0 


allows for a semi-parallel execution 
of programs. 

Batch mode can also be config- 
ured in chip.ini, with the two 
lines: 


[BATCH] 
BATCHMODE = 1 


Figure 2 shows a more complete 
example of a chip initialisation file. 


Local data transfer over 


the COM port 

The SC12 chip boasts a flash disk 
which is known to DOS as drive A:. 
There are two methods available for 
transferring data between the Per- 
sonal Mini Webserver and the PC, 
either over the network connection 
or via the COM interface. 

The XTRANS command is used to 
transfer files over the serial COM 
interface. The communication uses 
the well-known XModem protocol, 
which is available as standard on 
most terminal programs. For exam- 
ple, to transfer the file test.txt from 
the PC to the Personal Mini Web- 
server, the command 


XTRANS COM R TEST.TXT 


is given at the RTOS prompt. The 


Table 2. 


character R (receive) after the port 
identifier COM (K4), indicates the 
direction of data transfer. Next (and 
without too much delay) the file 
must be sent from the terminal pro- 
gram using the XModem protocol. 

For transfer in the opposite direc- 
tion, from Personal Mini Webserver 
to PC, the command 


XTRANS COM S TEST.TXT 


is used. The second serial interface, 
K3, has identifier EXT. Normally 
(except when a BIOS update is being 
carried out) this is where the modem 
is connected in a PPP server config- 
uration. The configuration and use of 
this interface will be described in 
more detail later. 


Network settings 


The most important aspect of the 
SC12 is the network connection. For 
our first experiments it is easiest to 
use Ethernet, since it is fast and 
easy to use. To construct the net- 
work, all that is required is a 
crossover twisted-pair cable with 
RJ45 connectors (or two cables and 
a hub) and an Ethernet card in the 
PC. The Ethernet driver in the $C12 
is only compatible with the ‘slow’ 
10Base-T Ethernet standard, and so 
in principle a 10Base-T card will be 
adequate. If, however, you are buy- 
ing a new Ethernet card, you might 
as well purchase a faster 100Base-T 
version, since they only cost about 
thirty pounds. 

We will consider here an existing 
network with the following IP set- 
tings: 


IP Adress: 
192.168.100.100 
Subnet Mask: 
255.255.255.0 


the file processed first. The most significant 
difference between the $C12’s operating sys- 


A:\DHCP 0 Disable automatic network 


configuration 
tem and ‘normal’ DOS is that DOS is at root a A:\IP 192.168.100.101 Set IP address... 
single-tasking operating system, while the A:\Netmask 255.255.255.0 .. net mask... 


SC12 always operates by default in multi- 
tasking mode. For that reason the prompt 
always returns very quickly after a program 


A:\Gateway 192.168.100.254 
A: \IPETH 


... and gateway address 
Activate new settings 
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Figure 3. Configuration of the IP address using Chiptool. 


Gateway: 
192.168.100.254 


The TCP/IP configuration of the Eth- 
ernet card can be found in the Sys- 
tem Settings under Network. The 
next address after the quoted ‘IP 
Address’ (i.e. 192.168.100.101) can- 
not already be assigned to a device 
on the network. 

Before the Personal Mini Web- 
server can communicate over the 
Ethernet, a number of addresses 
must be set. These are its own net- 
work address, the address of the net- 


work to which the Personal Mini 
Webserver is connected, and the 
address of the gateway (if present). 
The gateway allows devices on dif- 
ferent networks to communicate 
with one another. 

First we enter the settings manu- 
ally at the RTOS prompt, as shown in 
Table 2. 


To confirm the settings, reply to the 
message 


Reconfigure IP ethernet - 
ok 





Z MS-DOS Pret 





a e ee A 


Figure 4. Ping on the PC. 
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with the command 
A: \IPCFG 


and obtain the values: 
IP=192.168.100.101 
Netmask=255.255.255.0 
Gateway=192.168.100.254 
DHCP=0 

MAC= 00 30 56 FO 12 BE 


The last line gives the hardware address of 
the internal Ethernet controller and cannot be 
changed. These settings can also be applied 
using Chiptool (Figure 3) or, if preferred, as 
commands on autoexec.bat or entries in 
chip.ini. 

Once the Personal Mini Webserver is con- 
nected to a network, the connection can be 
tested using PING, which is part of RTOS. It 
is very easy to use: 


A:\PING 192.168.100.100 


This causes PING to send data from the $C12 
to the specified network address (in this case 
to the PC). The same can be done from the PC 
end, using the PING command, which, 
although a DOS program, is provided as part 
of Windows (Figure 4). Here, of course, the 
network address of the Personal Mini Web- 
server, and not of the PC, must be specified. 
If this all goes well, this indicates that com- 
munication has been successfully estab- 
lished. 

The settings can, as we said above, also 
be entered in chip.ini, for example as fol- 
lows: 


[IP] 
ADDRESS=192.168.100.170 
NETMASK=255.255.255.0 
GATEWAY=192.168.100.254 
DHCP=0 


FTP server 


Several protocols are built into the SC12 to 
enable easy handling of network traffic. 
Files can be transferred not only using the 
XTRANS command, but also, as might be 
expected for a webserver, over the TCP/IP 
network using the File Transfer Protocol 
(FTP). All that is required is an FTP client, 
such as is available in any Windows system 
and which can be started using the FTP com- 
mand in a DOS window. This command-line 
oriented program is, however, not exactly 
user friendly. If you are planning to use FTP 
extensively, a graphics-oriented program 
such as the universally-used WS-FTP pro- 
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char tmpbuffer[180]; 
[kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk/ 


//building the page 


[kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk/ 


//insert the head of the page 
strcpy (HtmlPage,PageHead); 
//append the given request arguments 


sprintf(tmpbuffer,”<BR>Method 
strcat(HtmlPage,tmpbuffer) ; 


%02d<BR>",CgiRequest->fHttpRequest ) ; 


sprintf (tmpbuffer,”<BR>Url 
strcat(HtmlPage,tmpbuffer); 


$s<BR>”",CgiRequest->fPathPtr); 


sprintf(tmpbuffer,”<BR>Host 
strcat(HtmlPage,tmpbuffer) ; 


$S<BR>" ,CgiRequest-—>fHostPtr); 


Sprintf(tmpbuffer,”<BR>Referer 
$S<BR>"”,CgiRequest->fRefererPtr) ; 
strcat(HtmlPage,tmpbuffer); 


sprintf(tmpbuffer,”<BR>User Agent : 
$S<BR>"”,CgiRequest->fAgentPtr); 
strcat(HtmlPage,tmpbuffer); 


sprintf(tmpbuffer,”<BR>Content : 
$S<BR>"”,CgiRequest->fLanguagePtr); 
strcat(HtmlPage,tmpbuffer); 


Ssprintf(tmpbuffer,”<BR>User 
$S<BR>” ,CgiRequest->fUserNamePtr); 
strcat(HtmlPage,tmpbuffer); 


sprintf (tmpbuffer,”<BR>Password : 
3$S<BR>” ,CgiRequest->fPasswordPtr); 
strcat(HtmlPage,tmpbuffer); 


if(strlen(CgiRequest->fArgumentBufferPtr ) ) 


{ 
sprintf(tmpbuffer,”<BR>Arguments: 


$S<BR>” ,CgiRequest->fArgumentBufferPtr ); 
} 


else 


t 
strcpy(tmpbuffer,”<BR>No arguments<BR>” ) ; 


} 
strcat(HtmlPage,tmpbuffer); 


//append the predefined tail 
strcat(HtmlPage,PageEnd); 
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[A kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkxkxk/ 


//give it to the webserver 
[A kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkxkk/ 


CgiRequest->fHttpResponse 
CgiRequest->fDataType 


CgiRequest->fResponseBufferPtr 
CgiRequest->fResponseBufferLength 


} 


= CgiHttpOk; 


= HtmlPage; 


//HTTP 200 OK 


CGIDataTypeHtml; //text/html 


strlen(HtmlPage); 


[kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 


*/ 


Figure 5. Example software fragment. 


gram can be used. This program is 


available from www.ipswitch.com/ 
Products/index.html. 

A user name and password are 
required to connect to an FTP server. 
These settings can only be placed in 
chip.ini. Two different identifiers 
and passwords are allowed. The 
default settings are: 


USER: ANONYMOUS 
NO PASSWORD 


BIOS upgrade 


and 


USER: FTP 
PASSWORD: FTP 


An FTP program also allows you, for 
example, to modify chip.ini or 
autoexec.bat remotely, or do 
upload new programs or Internet 


pages. 


The most important information in the start-up message is the BIOS version. Our 


software requires beta version V1! .00 or later. The most up-to-date version is 


available for download from Beck’s website, which can most conveniently be 


transferred to the SCI 2 using the Chiptool program, also downloadable from 


their site. The transfer can be done either locally via the PC’s COM interface, or 


remotely over TCP as can be seen from the Chiptool window. When upgrading 
the BIOS, note that the serial interface used is the SCI 2’s EXT connection, not 


the COM connection! 


+ Dog Mach DI 
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Telnet server 


In order to operate a device remotely it is not 
sufficient merely to be able to transfer files. It 
is also important to be able to run programs 
or restart devices. TCP/IP offers the Telnet 
protocol for these applications. The protocol 
allows you to operate a computer over a net- 
work as if you had direct access to its moni- 
tor and keyboard. 

A Telnet program can be used to establish 
a connection with the Personal Mini Web- 
server. On the screen, the appearance is sim- 
ilar to that of a terminal program communi- 
cating over the serial port. The standard set- 
tings for Telnet, which can be modified in 
chip.ini, are as follows: 


USER: TEL 
PASSWORD: TEL 


Using the command 
A: \REBOOT 


the Personal Mini Webserver can be rebooted 
remotely. 


Http server with CGI 


The best known application of TCP/IP is 
without doubt the Hypertext Transfer Proto- 
col (HTTP). This protocol is used by most 
browsers (Netscape Navigator, Internet 
Explorer, etc.) for displaying web pages. The 
SC12’s BIOS includes its own webserver. This 
means that you can store HTML pages in the 
Personal Mini Webserver and request them 
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Figure 6. Programming a LCD. 


using a browser. A page can contain images, 
Java applets, sounds and so on. 

Once the Personal Mini Webserver is con- 
nected to the network, the IP address must 
simply be entered into the browser to con- 
nect to the WEB@CHIP If no particular page 
is requested by the browser, the Personal 
Mini Webserver starts with the main page 
(usually index.htm or main.htm). In order 
for it to know which of the stored pages this is, 
the following should appear in chip. ini: 


[WEB] 
ENABLE=1 
MAINPAGE=INDEX .HTM 
DRIVE=0 
ROOTDIR=\WEB \ 


These pages should be stored in a separate 
directory in the general-purpose part of the 
flash disk. The file names must follow the 8.3 
naming convention. 

Publishing your own web pages is a 
diverting pastime, but our application aims 
to do more: we want to be able to obtain 
measurements over the network in real time, 
or control devices remotely. This is also made 
possible by the Hypertext Transfer Protocol 
(http). 

There are two ways to produce a web 
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page. The best known is to create an 
HTML file and send it to a browser. 
In most cases this is the ideal solu- 
tion. However, if, for example, only a 
temperature reading needs to be 
updated, this procedure is awkward 
and inelegant. The processor is con- 
tinuously occupied with producing 
and sending out new HTML pages 
which no-one requires. 

The best way to send real-time 
data over the network is to use a 
program that employs the Common 
Gateway Interface (CGI). Such a pro- 
gram can produce an HTML page at 
the moment it is requested and send 
it to the HTTP server. The program 
also might, for example, cause the 
digital inputs to be read and build an 
up-to-date result into an HTML 
page. 

CGI programs are also able to 
obtain information from the browser. 
Information entry is via HTML forms, 
which are used everywhere on the 
Internet. Information entered into 
the form is sent when the user clicks 
on the appropriate button. 

Since this method of sending out 
HTML pages is not common and not 


trusted by many users, we have pre- 
pared several ready-made and thor- 
oughly commented examples writ- 
ten using Borland C to show how the 
digital inputs and outputs are used, 
and how to control the LCD. The pro- 
grams are available free of charge 
from the Elektor Electronics website 
r (at nominal cost) on a disk with 
order code 010036-11. If you are rea- 
sonably familiar with C, you will 
have no difficulty in adapting these 
examples for your own purposes. 


Programming 


It is not necessary to become famil- 
iar with a new language and a new 
environment in order to program the 
Personal Mini Webserver. In princi- 
ple any (old) DOS compiler will do to 
generate code for the 80196. The 
most widely used programming 
environments, Borland C and Turbo 
Pascal, have been used with success 
in the Elektor Electronics laborato- 
ries. A host of DOS compilers are 
also available freely on the Internet. 

It is outside the scope of this arti- 
cle to go into the details of program- 
ming in C. Nevertheless, we can 
show a fragment of source code in 
Figure 5. This fragment would be 
called whenever a browser such as 
Internet Explorer, Netscape Naviga- 
tor or Lynx requests a page. The rou- 
tine constructs an HTML page 
which will be delivered by the HTTP 
server. 

Test programs which exercise the 
individual functions of the Personal 
Mini Webserver are available from 
the Elektor Electronics website as 
well as on the above mentioned pro- 
ject diskette. The source code is of 
course fully commented so that you 
will quickly get used to how the Per- 
sonal Mini Webserver works. As 
mentioned above, Beck’s company 
Internet site contains complete doc- 
umentation of all functions of the 
SC12 and its APIs, as well as an 
interesting FAO list and a lively 
newsgroup. Particularly interesting 
are the links to the colleges at Win- 
sen and Mosbach in Germany, 
where experimental systems have 
been developed using the SC12 and 
where comprehensive introductory 
courses are run. 

(010036-2) 
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